home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / lscan103.zip / LOGSCAN.DOC next >
Text File  |  1992-11-23  |  5KB  |  122 lines
  1.  
  2.  
  3. Program Name:  Logscanner                     11-10-92
  4.  
  5. Disclaimer:
  6.  
  7. Use of this program is affirmation that you will not hold the Author
  8. responsible in any way by the use of, or inability to use, this program.
  9.  
  10.  
  11. Introduction:
  12.  
  13.  This program came about by a friend asking if I could write a program
  14.  that would scan the BBS log looking for key words, and then write a 
  15.  message in the BBS to the sysop or the user or both.
  16.  
  17. How it works:
  18.  
  19.  Logscanner reads the config file specified in the command line and
  20.  then scans the BBS log looking for the matching string. Upon finding
  21.  a match it then enters a message in the BBS message area addressed to 
  22.  the sysop, user, or one to both, according to the config file. 
  23.  The program also make a log of all matches.
  24.  
  25. About Logscanner Config files:
  26.  
  27.  You create the config files using the Logscanner editor. To invoke the
  28.  editor just type "logscan" without any additional command line parameters
  29.  You will then be on a menu asking if you want to edit a config file or
  30.  the test file for the messages. Choose "C" for config file. It will then
  31.  ask for the config file name, Enter the name with an extension of ".CFG".
  32.  If this file doesn't exsist in the current directory it will ask if you
  33.  want to create it or not. Enter "Y" to create it. You will then be put
  34.  into the config file editor.
  35.  
  36.  The file created by the editor is in the following format.
  37.  
  38.  1. drive:\path\name.log
  39.  2. drive:\path\ 
  40.  3. Y/N
  41.  4. !/@/%/&
  42.  5. Y/N
  43.  6. Y/N
  44.  7. "String"
  45.  
  46.  1. This line is the drive, path and name of the BBS log file.
  47.  2. This line is the drive and path of the BBS config file (note,
  48.     must include trailing backslash).
  49.  3. This line tells the Logscanner whether or not to create a log file 
  50.     for this config file.  
  51.  4. This line indicates the mode for Logscanner to run in. 
  52.          ! - Indicates logfile only, no messages to enter. 
  53.          @ - Indicates enter the message addressed to the sysop. 
  54.          % - Indicates enter the message addressed to the user. 
  55.          & - Indicates enter two messages, one to the sysop and one
  56.              to the user.
  57.  5. This line tells Logscanner to make the messages private or not.
  58.  6. This line tells Logscanner to use the sysop's and user's alias or
  59.     not in the To: and From: fields.
  60.  7. This is the "string" that Logscanner looks for in the BBS log file.
  61.     This string must match the one looked for exactly. 
  62.  
  63. Logscanner .LGC text files:
  64.  
  65.  You create the .LGC text files using the Logscanner editor. To invoke 
  66.  the editor just type "logscan" without any additional parameters. 
  67.  You will then be on a menu asking if you want to edit a config file
  68.  or the test file for the messages. Choose "T" for text file. It will
  69.  then ask for the text file name. Enter the name with an extension of
  70.  ".LGC". If this file doesn't exist in the current directory it will ask
  71.  if you want to create it or not. Enter "Y" to create it. You will then
  72.  be put into the text file editor.
  73.  
  74.  You have 11 lines available to write the message in. This is a very
  75.  simple, overwrite text editor. The arrow keys work as well as the HOME
  76.  and END keys. The BACKSPACE key functions as a left arrow key. The DELETE
  77.  key doesn't work. Also, CTRL-HOME goes to the start of the text page and
  78.  CTRL-END goes to the end of the text page. Once you have entered the
  79.  message as you want it, hit the ESC key and it will ask you if you are
  80.  finished editing the text file.
  81.  
  82. Running Logscanner:
  83.  
  84.  To run the Logscanner in the scan mode type "logscan" with the 
  85.  parameter of the config file without the .CFG extension (i.e., 
  86.  LOGSCAN CONFIG). (Note, there must be both a matching .CFG file 
  87.  and .LGC text file.)
  88.  
  89.  You need to delete or rename the log file after scaning it or you
  90.  will get repeats everytime you scan the log.
  91.  
  92.  You need one config file and one text file for each string you
  93.  wish to scan for.
  94.  
  95. Registration:
  96.   
  97.   This program is fully usable as is. The only sign that it is
  98.   unregistered is in each message it enters, there is a note at the
  99.   bottom stating that it is unregistered. You have as long as you like 
  100.   to test this program. 
  101.  
  102.   Registration for this program is $5.00 (US).
  103.    
  104.   Send letter with your Name as it appears in the Ezycom Config file,
  105.   and either a Fido, Adultlinks, ToadNet, PODSNet, or PIXNet address
  106.   or a mailing address, with a check or money order (DO NOT SEND 
  107.   CASH) to the address below and I will send you a KEY file to you 
  108.   that will put your name as who the program is registered to in the 
  109.   messages posted.
  110.  
  111. To  Robin K. Cook  
  112.     PO Box 27034         
  113.     San Antonio TX  78227
  114.  
  115.         - or -
  116.  
  117.     FidoNet # 1:387/635
  118.     (210) 674-4978 (14.4K V32b V42b)
  119.  
  120. enjoy
  121.  
  122.